home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glminmax.z / glminmax
Encoding:
Text File  |  2002-10-03  |  8.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllMMMMiiiinnnnmmmmaaaaxxxx((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ggggllllMMMMiiiinnnnmmmmaaaaxxxx((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllMMMMiiiinnnnmmmmaaaaxxxx - define minmax table
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllMMMMiiiinnnnmmmmaaaaxxxx( GLenum _t_a_r_g_e_t,
  14.                     GLenum _i_n_t_e_r_n_a_l_f_o_r_m_a_t,
  15.                     GLboolean _s_i_n_k )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _t_a_r_g_e_t          The minmax table whose parameters are to be set.  Must be
  20.                      GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX.
  21.  
  22.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t  The format of entries in the minmax table.  Must be one
  23.                      of GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222,
  24.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888,
  25.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA,
  26.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222,
  27.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444,
  28.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666,
  29.                      GGGGLLLL____RRRR3333____GGGG3333____BBBB2222, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____RRRRGGGGBBBB4444, GGGGLLLL____RRRRGGGGBBBB5555, GGGGLLLL____RRRRGGGGBBBB8888, GGGGLLLL____RRRRGGGGBBBB11110000,
  30.                      GGGGLLLL____RRRRGGGGBBBB11112222, GGGGLLLL____RRRRGGGGBBBB11116666, GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____RRRRGGGGBBBBAAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA4444,
  31.                      GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111, GGGGLLLL____RRRRGGGGBBBBAAAA8888, GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA11112222, or
  32.                      GGGGLLLL____RRRRGGGGBBBBAAAA11116666.
  33.  
  34.      _s_i_n_k            If GGGGLLLL____TTTTRRRRUUUUEEEE, pixels will be consumed by the minmax process
  35.                      and no drawing or texture loading will take place.  If
  36.                      GGGGLLLL____FFFFAAAALLLLSSSSEEEE, pixels will proceed to the final conversion
  37.                      process after minmax.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      When GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX is enabled, the RGBA components of incoming pixels are
  41.      compared to the minimum and maximum values for each component, which are
  42.      stored in the 2-element minmax table.  (The first element stores the
  43.      minima, and the second element stores the maxima.)  If a pixel component
  44.      is greater than the corresponding component in the maximum element, then
  45.      the maximum element is updated with the pixel component value.  If a
  46.      pixel component is less than the corresponding component in the minimum
  47.      element, then the minimum element is updated with the pixel component
  48.      value.  (In both cases, if the internal format of the minmax table
  49.      includes luminance, then the R color component of incoming pixels is used
  50.      for comparison.)  The contents of the minmax table may be retrieved at a
  51.      later time by calling ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx.  The minmax operation is enabled or
  52.      disabled by calling ggggllllEEEEnnnnaaaabbbblllleeee or ggggllllDDDDiiiissssaaaabbbblllleeee, respectively, with an argument
  53.      of GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX.
  54.  
  55.      ggggllllMMMMiiiinnnnmmmmaaaaxxxx redefines the current minmax table to have entries of the format
  56.      specified by _i_n_t_e_r_n_a_l_f_o_r_m_a_t.  The maximum element is initialized with the
  57.      smallest possible component values, and the minimum element is
  58.      initialized with the largest possible component values.  The values in
  59.      the previous minmax table, if any, are lost.  If _s_i_n_k is GGGGLLLL____TTTTRRRRUUUUEEEE, then
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllMMMMiiiinnnnmmmmaaaaxxxx((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ggggllllMMMMiiiinnnnmmmmaaaaxxxx((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      pixels are discarded after minmax; no further processing of the pixels
  75.      takes place, and no drawing, texture loading, or pixel readback will
  76.      result.
  77.  
  78. NNNNOOOOTTTTEEEESSSS
  79.      ggggllllMMMMiiiinnnnmmmmaaaaxxxx is present only if GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg is returned when ggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg
  80.      is called with an argument of GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS.
  81.  
  82. EEEERRRRRRRROOOORRRRSSSS
  83.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not one of the allowable
  84.      values.
  85.  
  86.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not one of the
  87.      allowable values.
  88.  
  89.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllMMMMiiiinnnnmmmmaaaaxxxx is executed between the
  90.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  91.  
  92. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  93.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr
  94.  
  95.  
  96. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  97.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxx, ggggllllRRRReeeesssseeeettttMMMMiiiinnnnmmmmaaaaxxxx
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.